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OS/2 and USB 


OS/2 USB Driver Stack 
IDC interconnections 

Device attachment 

Class driver 
HID Driver 
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Hosteontrolers on OS/2 

UHCI 

OHCI 

EHCI (USB 2.0) not yett 
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£)rivGis ft 

Printer 

Keyboard / Mouse 

Audio 

Modem 

Mass Storage 

Ethernet 
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IDC Interconnections 

Attachment 

To USBD during Init 
To USBHID during InitComplete 

IDC between USBD and Host Driver 
IDC between USBD and Class Driver 
IDC betweed UDBHID and HID Driver 
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IDC between US 

HCD USBD 

Category Host 
Register HCD 
Category USBD 

Process IRQ 
Clear Stalled Pipe 


USBD * HCD 

Category Host 

Accept 10 
Cancel 10 
Reset Host 
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ID C between 

USBD Class 

Category Class 


Process IRQ 
Check Service 
Detach Device 


Class USBD 

Category USBD 

Register Class 
Set Configuration 
Set Interface 
Accept 10 
Cancel 10 
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EDO betweed UDBH1D and HDD drv 


USBHID HID 

Category Client 

Check Service 
Detach Device 
Process IRQ 


HID USBHID 

Category Class 

Accept 10 
Clear stalled dev. 
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vice Attachment 

UHCI Detects a change in the port status 

The virtual RootHub dev. in UHCI signals HubStatusChanged to 
USED 

USED Gets the new hub status and the status of the ports of the hub 
USED Gets the DeviceDescriptor 

USED Gets the length of the Configuration (max. 512 Bytes) 

USED Gets the Configuration 
USED looks for driver for this device 

Hub devices are handled by USED itself 

Enums all registered classdrivers and calls IDC 

USB IDC FUNCTION CHKSERV for non Hub devices 
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Receives USB_IDC_FUNCTION_CHKSERV 
Receives USB_IDC_FUNCTION_DETDEV 
Receives USB_IDC_FUNCTION_PRCIRQ 
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void far IDCEntry (PRP_GENIOCTL pRP) 

{ 

USHORT status = pRP->rph.Status; 
pRP->rph.Status =0; 

if (pRP->rph.Cmd ! = CMDGenlOCTL || !pRP->ParmPacket){ 
pRP->rph.Status |= STERR | USB_IDC_PARMERR; 

} 

else if (pRP->Category != USB_IDC_CATEGORY_CLASS){ 
pRP->rph.Status |= STERR | USB_IDC_WRONGCAT; 

> 

else 

{ 

switch (pRP->Function) 

{ 

case USB_IDC_FUNCTION_PRCIRQ: // 0x44 

pRP->rph.Status = status; 

IRQSwitch (pRP); 
break; 

case USB_IDC_FUNCTION_CHKSERV: // 0x45 

Service (pRP); 
break; 

case USB_IDC_FONCTION_DETDEV: // 0x46 

Detach (pRP); 
break; 
default: 

pRP->rph.Status |= STERR | USB_IDC_WRONGFUNC; 

} 

} 

pRP->rph.Status |= STDON; 
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31 % 

rj. 

Ull 

sclnricr tor c 

.tevice 



Class driver 

Check Vendor and Product ID 
Check Number of configurations 
Search for supported interface 
Check interface Needed Endpoints 
Set the Device Interface 

HID device driver 

Check Usage (Page, Features ...) 
Get Report offsets 
Set Idle Time 


I 
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void Service (PRP_GENIOCTL pRP_GENIOCTL) 

{ 

Deviceinfo FAR *pDevInfo; 

DeviceEndpoint FAR *pEndPointD; 

USBSetConf setConf; 

RP_GENIOCTL rp; 

USHORT Vsrlndex, uslnterface, usIFace; 

UCHAR ucEndp; 

pDevInfo = ((USBCDServe FAR *)pRP_GENIOCTL->ParmPacket)->pDeviceInfo; 
if (pDevInfo->bConfigurationValue) 

{ 

// already configured 

pRP_GENIOCTL->rph.Status = USB_IDC_RC_SERVREJCTD; 
return; 

} 

if ( pDevInfo->descriptor.idVendor != VENDOR_HANDSPRING || 
pDevInfo->descriptor.idProduct != PRODUCT_VISOR || 
pDevInfo->descriptor.bcdDevice != DEVICE_RELEASE || 
pDevInfo->descriptor.bNumConfigurations != 1) 

{ 

pRP_GENIOCTL->rph.Status = USB_IDC_RC_SERVREJCTD; 
return; 

} 
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typedef struct Deviceinfo 


UCHAR 

CtrlID; 

// 

(00) controller ID 

UCHAR 

deviceAddress; 

// 

(01) USB device address 

UCHAR 

bConfigurationValue; 

// 

(02) USB device configuration 



// 

value 

UCHAR 

blnterfaceNumber; 

// 

(03) 0 based index in 



// 

interface array for this item 

UCHAR 

lowSpeedDevice; 

// 

(04) 0 for full speed device, 



// 

nonzero - low speed device 

UCHAR 

portNum; 

// 

(05) port number to which 



// 

device is attached 

USHORT 

parentHublndex; 

// 

(06) index in hub table to 



// 

parent hub. 



// 

-1 for root hub device 

HDEVICE 

rmDevHandle; 

// 

(08) RM device handle 

SetupPacket 

clearStalled; 

// 

(12) setup packet for USBD 



// 

internal use 

DeviceDescriptor 

descriptor; 

// 

(20) Device descriptor 

UCHAR 

configurationData [MAX CONFIG LENGTH]; // (38) device 




// configuration data 




// (1062) 

Deviceinfo; 
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EJSB Device Descriptor 


Typedef struct _device_descriptor 
{ 


UCHAR 

bLength; 

// 

UCHAR 

bDescriptorType; 

// 

USHORT 

bcdUSB; 

// 

UCHAR 

bDeviceClass; 

// 

UCHAR 

bDeviceSubClass; 

// 

UCHAR 

bDeviceProtocol; 

// 

UCHAR 

bMaxPacketSizeO; 

// 

USHORT 

idVendor; 

// 

USHORT 

idProduct; 

// 

USHORT 

bcdDevice; 

// 

UCHAR 

iManufacturer; 

// 



// 

UCHAR 

iProduct; 

// 



// 

UCHAR 

iSerialNumber; 

// 



// 

UCHAR 

bNumConfigurations; 

// 



// 

DeviceDescriptor; 



(00) Size of descriptor in bytes 
(01) 0x01 - DEVICE Descriptor type 
(02) USB Specification Release Number 
(04) Class Code 
(05) Subclass Code 
(06) Protocol Code 

(07) Maximum packet size for endpoint 0 

(08) Vendor ID 

(10) Product ID 

(12) Device release number 

(14) Index of string descriptor 
describing manufacturer 

(15) Index of string descriptor 
describing product 

(16) Index of string descriptor 
describing device 1 s serial number 

(17) Number of possible configurations 

(18) 
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if (!(usIFace=SearchConfiguration((PUCHAR)&pDevInfo->configurationData, 

pDevInfo->descriptor.bNumConfigurations, 
INTERFACE_CLAS S_VENDOR, 
INTERFACE_SUBCL_RESERVED, 
INTERFACE_PROTOCOL_RESERVED))) 

{ 

pRP_GENIOCTL->rph.Status = USB_IDC_RC_SERVREJCTD; 
return; 

} 


pDevInfo->bConfigurationValue = LOBYTE(uslnterface); 
// Update global device list 

gVisors[Vsrlndex].bConfValue = LOBYTE(uslnterface); 
gVisors[Vsrlndex].blnterface = HIBYTE(uslnterface); 


Warpstoek 2001 






for(ucEndp=l;ucEndp<=VISOR_NUM_BULKPIPES;ucEndp++) { 

pEndPointD — GetEndpointDPtr < pDevInfo->configurationData, 

pDevInfo->descriptor.bNumConfigurations, gVisors[Vsrlndex].bConfValue 
0, ucEndp | DEV_ENDPT_DIRIN); 
if ( pEndPointD && 

(<pEndPointD->bmAttributes & DEV_ENDPT_ATTRMASK) = DEV_ENDPT_BULK)) 

{ 

gVisors[VsrIndex].blnEndpoint[ucEndp] = ucEndp | DEV_ENDPT_BULK; 
gVisors[Vsrlndex].wMaxInSize[ucEndp] = pEndPointD->wMaxPacketSize; 

} 

else 

{ 

pRP_GENIOCTL->rph.Status = USB_IDC_RC_SERVREJCTD; 
return; 

} 

pEndPointD = GetEndpointDPtr ( pDevInfo->configurationData, 

pDevInfo->descriptor.bNumConfigurations, gVisors[Vsrlndex].bConfValue 
0, ucEndp | DEV_ENDPT_DIROUT); 
if ( pEndPointD && 

((pEndPointD->bmAttributes & DEV_ENDPT_ATTRMASK) == DEV_ENDPT_BULK)) { 

gVisors[Vsrlndex].bOutEndpoint[ucEndp] = ucEndp | DEV_ENDPT_DIROUT; 
gVisors[Vsrlndex].wMaxOutSize[ucEndp] = pEndPointD->wMaxPacketSize; 

} 

else { 

pRP_GENIOCTL->rph.Status = USB_IDC_RC_SERVREJCTD; 
return; 

} 
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Set ctevioe configuration 


gVisors[VsrIndex].pDevicelnfo = pDevInfo; 
gVisors[Vsrlndex].active = TURNON; 
gNoOfVisors++; 


// Set Visor Configuration. The request and the request's parameters 
// are sent to the device in the setup packet. 


SgVisor.setPack; 
pDevInfo->ctrlID; 
pDevInfo->deviceAddress; 
GetDS(); 


setConf.setConfiguration 
setConf.controllerld 
setConf.deviceAddress 
setConf.classDriverDS 
// desired configuration 

setConf.configurationValue = gVisors[Vsrlndex].bConfValue; 
setConf.irqSwitchValue = VISOR_IRQ_SETCONF; 
setConf.category = USB_IDC_CATEGORY_CLASS; 
setmem ((PSZ)&rp, 0, sizeof(rp)); 
rp.rph.Cmd = CMDGenlOCTL; 
rp. Category = USB_IDC_CATEGORY_USBD ; 
rp.Function = USB_IDC_FUNCTION_SETCONF; 
rp.ParmPacket = (PVOID)fisetConf; 


// IRQ processor category 


USBCalllDC (gpUSBDIDC, gdsUSBDIDC, &rp); 


pRP_GENIOCTL->rph.status = USB_IDC_RC_OK; 

> 
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typedef struct _USBRb { 

controller ID 

USB dev. address. Valid [1,127], 0 for unconfigured 
device endpoint ID, valid [0,15] 
device status on request complete 
Low order byte sets transfer type, 

High order byte gives packet details 
Virtual address of data buffer 
Buffer length in bytes 

Virtual address of second data buffer. 

Buffer length in bytes 

Required service frequency in ms. Valid [0,255]. 
maximum packet size to be used for this endpoint 
Address of IRQ routine to be called for this request 
DS value for IRQ processing routine 
callers category (used in IRQ extension calls) 
data to be stored within request 
data to be stored within request 
data to be stored within request 

max. error count. Valid [0,3]. 0 - no error limit. 
(42) far pointer to chained request block, not used 
alt interface index support, 
used when USRB_FLAGS_ALT_INTF is on 
aquests (USRB_FLAGS_DET_ISOHR is set in 'flags' 
ishronous request flags (opening call, regular call, 
last call, cancel call, info call) 

# of bytes to be sent in a frame (only opening call) 
max no of active buffers( only opening call) 


UCHAR 

controllerld; 

// 

(00) 

UCHAR 

deviceAddress; 

// 

(01) 

JCHAR 

endPointld; 

// 

(02) . 

UCHAR 

status; 

// 

(03) 

USHORT 

flags; 

// 

(04) 



// 


PUCHAR 

bufferl; 

// 

(06) 

USHORT 

bufferlLength; 

// 

(10) 

PUCHAR 

buffer2; 

// 

(12) 

USHORT 

buffer2Length; 

// 

(16) 

USHORT 

serviceTime; 

// 

(18) 

USHORT 

maxPacketSize; 

// 

(20) 

PUSBIDCEntry usbIDC; 

// 

(22) 

USHORT 

usbDS; 

// 

(26) 

UCHAR 

category; 

// 

(28) 

ULONG 

requestDatal; 

// 

(29) 

ULONG 

requestData2; 

// 

(33) 

ULONG 

requestData3; 

// 

(37) 

UCHAR 

maxErrorCount; 

// 

(41) 

struct 

USBRb FAR *nextRb 

i II 

UCHAR 

altlnterface; 

// 

(46) 



// 


// fields used for isohronous r 

UCHAR 

isoFlags; 

// 

(47) 



// 


USHORT 

isoFrameLength 

;// 

(48) 

USHORT 

isoBuffers; 

// 

(50) 



// 

(52) 


> USBRB; 
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typedef struct setup Packet { 


UCHAR bmReque s tType; // 


UCHAR 

bRequest; 

// 

USHORT 

wValue; 

// 



// 

USHORT 

wIndex; 

// 

USHORT 

wLength; 

// 

SetupPacket; 



D7: Data transfer direction 
0 = Host-to-device 
1 = Device-to-host 
D6...5: Type 
0 = Standard 

1 = Class 

2 = Vendor 

3 = Reserved 

D4...0: Recipient 
0 = Device 

1 = Interface 

2 = Endpoint 

3 = Other 

4...31 = Reserved 


(00) Characteristics of request 
(01) Specific Request 

(02) Word-sized field 

(value depends on request) 
(04) typically Index or Offset 
(06) Number of bytes to Transfer 


0 GET_STATUS 

1 CLEAR_FEATURE 

2 Reserved for future use 

3 SET_FEATURE 

4 Reserved for future use 

5 SET_ADDRESS 

6 GET_DESCRIPTOR 

7 SET_DESCRIPTOR 

8 GET_CONFIGURATION 

9 SET_CONFIGURATION 

10 GET_INTERFACE 

11 SET_INTERFACE 

12 SYNCH FRAME 
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HID Device attachment 


void JOYserv (RP_GENIOCTL FAR *pRP_GENIOCTL) 

{ 

USHORT index, joylndex; 

USBHIDServe FAR *pServData; 

ReportItemData FAR *pltem; 

USHORT usOffSet; 

// Check for free entry 

if (gNoOfJOYs < MAX_JOYS) 

{ 

for (joylndex =0; joylndex < MAX_JOYS; joyIndex++) 
if (!gJOY[j oylndex].active) 
break; 

> 

else 

{ 

pRP_GENIOCTL->rph. Status = USB_IDC_RC_SERVRE JCTD ; 
return; 

} 

pServData = (USBHIDServe FAR *)pRP GENIOCTL->ParmPacket; 
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USBHID! 




typedef struct _USBHIDServe 

{ 


Deviceinfo FAR *pDeviceInfo; // 

DeviceConfiguration FAR *devConf; // 


ReportItemData FAR 
ItemUsage FAR 
ItemDesignator FAR 
ItemString FAR 
USHORT 
USHORT 

} USBHIDServe; 


★itemData; // 
*itemUsage; // 
★ItemDesignator;// 
★itemstring; // 
reportItemlndex;// 
versionFlags; // 



far ptr to device data 
far ptr to device config. data 
ptr to report item data array 
ptr to extra usage data array 
ptr to extra designator data array 
ptr to extra string data array 
starting report item index itemData 
specific version flags (HID drafts) 
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index = pServData->reportItemIndex; 
while (index != LAST_INDEX) 

{ 

pihem = pServData->itemData + index; 

if ( pItem->mainType = HID_REPORT_TAGS_MAIN_COLL && 

pi tem->itemFeatures . usagePage = HID_USAGE_PAGE_GDESKTOP && 
pItem->localFeatures.usageMin = HID_GDESKTOP_USAGE_JOYSTICK && 
pitem->localFeatures.usageMax = HID_GDESKTOP_USAGE_JOYSTICK ) 

{ 

break; 

} 

index = pItem->indexToNextItem; 

} 

if (index = LAST_INDEX) 

{ 

// no Joystick 

pRP_GENI OC TL - >rph. Status = USB_IDC_RC_SERVRE JCTD ; 
return; 

} 
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Rep ortltemData 

typedef struct _RepItemData 
{ 


UCHAR 

used; 

// 

UCHAR 

interface; 

// 

UCHAR 

mainType; 

// 

// 

USHORT 

itemFlags; 

// 

USHORT 

parColIndex; 

// 

// 

USHORT 

indexToNextItern; 

// 

// 

// item features 


ItemFeatures 

itemFeatures; 

// 

// item local 

data 


LocalFeatures 

localFeatures; 

// 

// 

ReportltemData; 



00 nonzero if allocated 
01 interface index 
02 item type - input, output, 
feature, collection 
03 item flags 

05 parent collection index 

(LAST_INDEX - no parent collection) 
07 index to next main item for this 
report 

09 


41 

59 
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typedef struct _item_features 
{ 


UCHAR 

reportID; 

// 

ULONG 

reportSize; 

// 

ULONG 

reportCount; 

// 

USHORT 

usagePage; 

// 

LONG 

logMin ; 

// 

LONG 

logMax; 

// 

LONG 

phyMin; 

// 

LONG 

phyMax; 

// 

ULONG 

unit; 

// 

UCHAR 

unitExponent 

// 



// 


} ItemFeatures; 


report ID item belongs to 
data size for this item 
element count for current item 
item's usage page 
logical minimum for this item 
logical maximum for this item 
physical value minimum 
physical value maximum 
units of measurement 
exponent value 


09 

10 

14 

18 

20 

24 

28 

32 

36 

40 

41 


Warpstoek 2001 




typedef struct _local_features 
{ 


// usage information 


USHORT 

usagePage; 

// 

USHORT 

usageMin; 

// 

USHORT 

usageMax; 

// 

USHORT 

indexToUsageList; 

// 

// physical data references 


USHORT 

designatorMin; 

// 

USHORT 

designatorMax; 

// 

USHORT 

indexToDesignator 

;// 

// string data 

references 


UCHAR 

stringMin; 

// 

UCHAR 

stringMax; 

// 

USHORT 

indexToStrings; 

// 



// 


} LocalFeatures; 


41 local (only this item) usage page 
43 usage minimum 
45 usage max imum 
47 

49 

51 

53 

55 

56 

57 
59 
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// Check if the total report Length of the device can be handled 

gJOY[joyIndex].ReportLength = 0; 
index = pServData->reportItemIndex; 

while (index != LAST_INDEX) 

{ 

pitern = pServData->itemData + index; 

gJOY[joylndex].ReportLength += pItem->itemFeatures.reportSize* 

pitem->itemFeatures.reportCount; 

index = pItem->indexToNextItem; 


gJOY[joylndex].ReportLength= (gJOY[joylndex].ReportLength+BITS_IN_BYTE-l) 

/BIT S_IN_B YTE ; 

if(gJOY[joylndex].ReportLength > sizeof(gJOY[joylndex].buffer)) 

{ 

// Report is to long 

pRP_GENIOCTL->rph.Status = USB_IDC_RC_SERVREJCTD; 
return; 
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for needed reports 


index = pServData->reportItemIndex; 
usOffSet =0; 

gJOY[j oyIndex].ulCapsAxes = 0; 
gJOY[joyIndex].ulCapsSliders = 0; 

setmem((PSZ)&gJOY[joyIndex].DevCapsJoy,0,sizeof(DEVCAPS)); 

setmem((PSZ)&gJOY[joyIndex].joyState,0,sizeof(JOYSTATE)); 

setmem((PSZ)figJOY[joyIndex].AxeUnits,0,sizeof(JOYAXEUNIT)*JOYMAX_AXES); 

setmem((PSZ)figJOY[joylndex].Items,FULL_BYTE,sizeof(JOYITEM)*JOYMAXITEMS); 

while (index ! = IAST_INDEX) { 

pitern = pServData->itemData + index; 

if ( pItem->mainType == HID_REPORT_TAGS_MAIN_INPUT && 

pItem->itemFeatures . usagePage = HID_USAGE_PAGE_GDESKTOP) { 

if ( pItem->localFeatures.usageMin >= HID_GDESKTOP_USAGE_X && 
pItem->localFeatures.usageMax <= HID_GDESKTOP_USAGE_Z ) { 
usOffSet = SetupXYZAxes(joyIndex, pltera, usOffSet); 
gJOY[joyIndex].ininterface = pltem->interface; 

} 

else 
( ... } 
else 
{ ... } 

index = pi tern->indexToNextI tern; 

} 
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if ( (ULONG)0==gJOY[joylndex].DevCapsJoy.ulButtons || 

(ULONG)0==gJOY[j oyIndex] .DevCapsJoy.ulAxes) { 

// No Axes or No buttons 

pRP_GENIOCTL->rph. Status = USB_IDC_RC_SERVRE JCTD; 
return; 

} 

gJOY[joyIndex].joy Addr — pServData->pDeviceInfo->deviceAddress; 
gJOY[joyIndex].controllerlD = pServData->pDeviceInfo->ctrlID; 
gJOY[joyIndex].interruptPipeAddress = 

GetlnterruptPipeAddr( pServData->pDeviceInfo->configurationData, 

pServData->pDeviceInfo->descriptor.bNumConfigurations, 
pServData->pDeviceInfo->bConfigurationValue, 
gJOY[joyIndex].ininterface); 

gJOY[joylndex].setITpack.bmRequestType = REQTYPE_TYPE_CLASS | 

REQT YPE_REC I PIENT_INTERFACE; 

gJOY[j oyIndex].setITpack.bRequest = HID_REQUEST_SET_IDLE; 

gJOY[joylndex].setITpack.wValue = 0x0000; // all reports only if changed 

gJOY[j oyIndex].setITpack.wIndex = gJOY[joylndex].ininterface; 
gJOY[joyIndex].setITpack.wLength = NULL; 
gJOY[joyIndex].active = TURNON; 
gNoOfJOYs++; 

SetldleTime (joyIndex / JOY_IRQ_STATUS_IDLESET); 
pRP_GENIOCTL->rph.status = USB_IDC_RC_OK; 

} 
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void SetldleTime (USHORT joyIndex, USHORT kbdIRQstatus) 
USBRB rbHID; // I/O request block 

RP GENIOCTL rpHID; // request packet 


{ 


rbHID.bufferl 
rbHID.buffer1Length 
rbHID.buffer2 
rbHID.buffer2Length 


(PUCHAR)SgJOY[joylndex].setITpack; 
sizeof(gJOY[joylndex].setITpack); 
NULL; 

NULL; 


rbHID.controllerld 
rbHID.deviceAddress 
rbHID.endPointld 
rbHID.status 


gJOY[j oylndex].controllerlD; 
gJOY[j oylndex] .j oyAddr; 
USB_DEFADLT_CTRL_ENDPT; 

0; // not used 


rbHID.flags 
rbHID.serviceTime 
rbHID.maxPacketSize 
rbHID.maxErrorCount 
rbHID.usbIDC 
rbHID.usbDS 
rbHID.category 

rbHID.requestDatal = JOY_IRQ_STATUS_IDLESET; // MAKEULONG (kbdIRQstatus,0); 

rbHID.requestData2 = MAKEULONG (joylndex, 0) ; 

rbHID.requestData3 =0; // not used 

setnem( (PSZ)firpHID, 0, sizeof(rpHID)); 

rpHID.rph.Cmd = CMDGenlOCTL; 

rpHID. Category = USB_IDC_CATEGORY_CLASS ; 

rpHID. Function = USB_IDC_FUNCTION_ACCIO; 

rpHID.ParmPacket = (PVOID)SrbHID; 


= USRB_FLAGS_TTYPE_SETUP; 

= USB_DEFAULT_SRV_INTV; 

= USB_DEFAULT_PKT_SIZE; 

= USB_MAX_ERROR_COUNT; 

= (PUSBIDCEntry)JOYidc; // Address of IRQ processor function 

= GetDS () ; 

= USB_IDC_CATEGORY_CLIENT; // set client layer as IRQ processor 


USBCalllDC (gpHIDIDC, gdsHIDIDC, (RP_GENIOCTL FAR *)firpHID); 

) 
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USHORT SetupPOVs(USHORT joylndex, ReportltemData FAR *pltem, USHORT usOffset) 

{ 

USHORT usCount; 
usCount = 0; 

while( usCount < (USHORT)pItem->itemFeatures.reportCount && 
gJOY[joyIndex].DevCapsJoy.ulPOVs < MAX_POVS) 

{ 

gJOY[joylndex].Items[JOYOFS_POVO+usCount].bReport = pItem->itemFeatures.reportID; 

gJOY[joylndex].Items[JOYOFS_POVO+usCount].usOffse = usOffset; 

gJOY[joylndex].Items[JOYOFS_POVO+usCount].usReportSize = 

(USHORT)pitem->itemFeatures.reportSize; 

gJOY[joylndex].AxeUnits[JOYOFS_POVO+usCount].logMin = pItem->itemFeatures.logMin; 
gJOY[joylndex].AxeUnits[JOYOFS_POVO+usCount].logMax = pItem->itemFeatures.logMax; 
gJOY[joylndex].AxeUnits[JOYOFS_POVO+usCount]. phyMin = pItem->itemFeatures.phyMin; 
gJOY[joylndex].AxeUnits[JOYOFS_POVO+usCount].ph/fax = pItem->itemFeatures.phyMax; 
gJOY[joylndex].AxeUnits[JOYOFS_POVO+usCount].unit = pItem->itemFeatures.unit; 
gJOY[joylndex].AxeUnits[JOYOFS_POVO+usCount].unitExponent = 

pitem->itemFeatures.unitExponent; 

gJOY[j oylndex].DevCapsJoy.ulPOVs++; 
usOffset += pitem->itemFeatures.reportSize; 
usCount++; 



// Just in case the device has more than MAX_POVS Hatswitches 
usOffset += pitern->itemFeatures.reportSize * 

(pitern->itemFeatures.reportCount- usCount); 

return usOffset; 

} 
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void InterruptDataReceived (RP_GENIOCTL FAR *pRP_GENIOCTL) 

{ 

USBRB FAR *processedRB; 


*pIntData; 
j oyIndex, i; 
lvalue; 


BYTE 

USHORT 

LONG 


processedRB = (USBRB FAR *)pRP_GENIOCTL->ParmPacket; 
joylndex = LOUSHORT (processedRB->requestData2); 

if (gDevice) 

if (joylndex != gJoyIndex) 
return; 

plntData = (BYTE *)&gJOY[joylndex].buffer; 

setanem((PSZ)figJOY[joyIndex]•joyState, 0, sizeof(JOYSTATE)); 
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i=0; 

while(i< (USHORT)gJOY[joyIndex].DevCapsJoy.ulPOVs) 

< 

lvalue = GetLogValue(j oylndex, JOYOFS_POVO+i); 
if(lvalue) 

< 

if( gJOY[joylndex].AxeUnits[JOYOFS_POVO+i].unit) 

{ 

// Assume degrees and log 1 as top which is 0° 
lvalue = (lvalue -1)* 

(gJ0Y[joyIndex].AxeUnits[JOYOFS_POVO+i].phyMax- 
gJOY[joyIndex].AxeUnits[JOYOFS_POVO+i].phyMin)/ 

(gJOY[joyIndex] .AxeUnits[JOYOFS_POVO+i].logMax- 
gJOY[joyIndex].AxeUnits[JOYOFS_POVO+i].logMin); 

// Report in hundredths of degrees 

if( gJOY[joylndex].AxeUnits[JOYOFS_POVO+i].phyMax>=270 && 
gJOY[joylndex].AxeUnits[JOYOFS_POVO+i].phyMax<=360) 
lvalue *=100; 

> 

else 

{ 

// No Units so no physical values translate to degrees 

lvalue = (lvalue-1) * (36000/gJOY[joylndex].AxeUnits[JOYOFS_POVO+i].logMax); 

> 

} 

else 

{ 

lvalue = OxOOOOFFFF; // centered 

) 

gJOY[joylndex].joyState.rgdwPOV[i] = lvalue; 
i++; 
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Item 



typedef struct 
{ 

UCHAR 

USHORT 

USHORT 

USHORT 

USHORT 

} ItemUsage; 


item usage 


used; 

indexToNextUsageData; 
usagePage; 
usageMin; 
usageMax; 


// nonzero if allocated 

// local (only this item) usage page 
// usage minimum 
// usage maximum 


typedef struct _item_designator 
( 



UCHAR 

used; 


// nonzero if allocated 


USHORT 

indexToNextDesignatorData 

r 


USHORT 

designatorMin; 


// designator minimum 


USHORT 

designatorMax; 


// designator maximum 

} 

ItemDesignator 

f 



typedef struct _item_strings 
/ 




UCHAR 

used; 

// 

nonzero if allocated 


USHORT 

indexToNextStringData; 




UCHAR 

strin^lin; 

It 

string minimum 


UCHAR 

stringMax; 

// 

string maximum 


Itemstring; 
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Gets called from the IDC function to process 
U SB_IDC_FUN CTION_PRCIRQ 


Each call to a USBCalllDC is followed by an 
IRQ which gets processed in it 
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void JOYirq (RP_GENIOCTL FAR *pRP_GENIOCTL) 

{ 

USBRB FAR *processedRB; 

UCHAR oldCat; 

processedRB = (USBRB FAR *)pRP_GENIOCTL->ParmPacket; 

if (pRP_GENI OCTL - >rph. Status ! = USB_IDC_RC_OK) 

{ 

if (processedRB->status & USRB_STATUS_STALLED) 

{ 

if ( processedRB->reques tDatal! =JOY_IRQ_STATUS_STALLED ) 

< 

oldCat=pRP_GENIOCTL->Category; 

JOYClearStalled(pRP_GENIOCTL); 
pRP_GENIOCTL->Category=oldCat; 

} 

return; 

} 

return; 

} 
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switch (processedRB->requestDatal) 
{ 


case JOY IRQ STATUS IDLESET: 


pRP_GENI OC TL - >rph. Status=STATUS_DONE ; 
ReadlnterruptPipe (pRP_GENIOCTL) ; 
break; 

case JOY_IRQ_STATUS_DURATION: 
break; 

//always ok 

case JOY IRQ STATUS INTPIPE: 



InterruptDataReceived (pRP_GENIOCTL); 
ReadlnterruptPipe (pRP_GENIOCTL); 
break; 

case JOY_IRQ_STATUS_SETACK: 
break; 

case JOY_IRQ_STATUS_STALLED : 

ReadlnterruptPipe (pRP_GENIOCTL) ; 
break; 
default:; 

} 

} 
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ReadlnterruptPipe 

void ReadlnterruptPipe (PRP_GENIOCTL pRP_GENIOCTL ){ 

USBRB FAR *processedRB; 

USBRB hcdReqBlock; 

RP_GENIOCTL rp_USBReq; 

USHORT deviceIndex; 

proces sedRB = (USBRB FAR *)pRP_GENIOCTL->ParmPacket; 
deviceIndex = LOUSHORT(processedRB->requestData2); 

setmem((PSZ)gJOY[deviceindex].buffer, UI_RESERV, sizeof(gJOY[deviceindex].buffer)); 
hcdReqBlock.controllerId = processedRB->controllerId; 

hcdReqBlock.deviceAddress = processedRB->deviceAddress; // use default address 

hcdReqBlock.endPointld = gJOY[deviceindex].interruptPipaAddress; 

hcdReqBlock.status =0; // not used 

hedRaqBlock.flags = USRB_FLAGS_TTYPE_IN | USRB_FLAGS_DET_INTRPT; 

if (!(processedRB->flags & USRB_FI*AGS_DET_DTGGLEON)) 
hcdReqBlock.flags |= USRB_FLAGS_DET_DTGGLEON; 
hcdReqBlock.bufferl = (PUCHAR)gJOY[deviceindex].buffer; 

hcdReqBlock.bufferlLength = gJOY[deviceindex].ReportLength; 

hcdReqBlock.buffer2 = NULL; // no additonal data to be sent to/from host 

hcdReqBlock.buffer2Length =0; //to complete this request 

hcdReqBlock.serviceTima = USB_DEFAULT_SRV_INTV; 

hcdReqBlock.maxPacketSize = USB_DEFAULT_PKT_SIZE; 

hcdReqBlock.maxErrorCount = USB_MAX_ERROR_COUNT; 

hcdReqBlock.usbIDC = (PUSBIDCEntry)JOYidc; // Address of IRQ proc. 

hcdReqBlock .usbDS — GetDSO; 

hcdReqBlock.category = USB_IDC_CATEGORY_CLIENT; // set USBD layer as IRQ processor 

hcdReqBlock.requestDatal = JOY_IRQ_STATUS_INTPIPE; 

hcdReqBlock.requestData2 = MAKEULONG(deviceIndex, 0); // index in device table 

hcdReqBlock.requestData3 =0; // not used 

setmem((PSZ)&rp_USBReq, 0, sizeof(rp_USBReq)); 

rp_USBReq.rph.Cmd = CMDGenlOCTL; 

rp_USBReq.Category = USB_IDC_CATEGORY_CLASS; 

rp_USBReq.Function = USB_IDC_FUNCTION_ACCIO; 

rp_USBReq.ParmPacket = (PVOID)ShedRaqBlock; 

USBCalllDC (gpHIDIDC, gdsHIDIDC, (RP_GENIOCTL FAR *)&rp_USBReq); 
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LONG GetLogValue{ USHORT joyIndex, USHORT ItemOfs) 

{ 

LONG ro = 0; 

USHORT usOffset, usByteOfs, StartBit, usSize; 

BYTE *pIntData, bRem; 

usOffset = gJOY[joylndex].Items[ItemOfs].usOffset; 
usSize = gJOY[joylndex].Items[ItemOfs].usReportSize; 
plntData = (BYTE *)&gJOY[joylndex].buffer; 

// No proper index or Value to long 
if ( (FULL_WORD=usOffset) || (usSize>32) ) 
return rc; 

StartBit = usOffset %8; 
usByteOfs = usOffset /8; 

//Check if in bounds of report 
if(usByteOfs>=gJOY[joylndex].ReportLength) 
return rc; 

if(usSize>l) 

if(!StartBit){ 

// probably the easiest 
while(usSize>=8) { 
re *= 256; 

rc += plntData[usByteOfs++]; 
usSize-=8; 

> 

if(usSize){ 

rc *= (2*usSize); 

bRem = plntData[usByteOfs]; 

bRem »=(8-usSize) ; 

re += bRem; 

> 

) 
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else{ 

if( (StartBit-usSize)<=0){ 

// All bits are in this byte 
bRem = plntData[usByteOfs]; 
bRem &= gRightMask[StartBit]; 
bRem »— (8-usSize-StartBit) ; 
rc = bRem; 

> 

else 

{ 

bRem = plntData[usByteOfs++]; 
bRem &=gRightMask[StartBit]; 
re = bRem; 

usSize -= (8-StartBit); 
while(usSize>=8){ 
rc *= 256; 

rc += plntData[usByteOfs++]; 
usSize-=8; 

} 

if(usSize){ 

rc *= (2*usSize); 

bRem = plntData[usByteOfs]; 

bRem »=(8-usSize) ; 

rc += bRem; 

> 

> 

} 

} 

else 

{ //I Byte only 

bRem = plntData[usByteOfs] & gBitMask[StartBit]; 
bRem »= (7-StartBit) ; 
re = bRem; 

) 

return rc; 

} 
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Useful information link 


'M 


General info docs etc www.usb.org 

USB device information www.linux-usb.org 

Sources for many linux USB drivers 
www.sourceforge.net 

The OS/2 DDK with sources of USB drivers 
service.boulder.ibm.com/ddk/ 
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